The _x_m_h program provides a graphical user interface to the
_M_H Message Handling System. To actually do things with your
mail, it makes calls to the _M_H package. Electronic mail
messages may be composed, sent, received, replied to,
forwarded, sorted, and stored in folders. _x_m_h provides
extensive mechanism for customization of the user interface.
This document introduces many aspects of the Athena Widget
Set.
OOOOPPPPTTTTIIIIOOOONNNNSSSS
----ppppaaaatttthhhh _d_i_r_e_c_t_o_r_y
This option specifies an alternate collection of
mail folders in which to process mail. The
directory is specified as an absolute pathname. The
default mail path is the value of the Path component
in the _M_H profile, which is determined by the MMMMHHHH
environment variable and defaults to
$HOME/.mh_profile. $HOME/Mail will be used as the
path if the _M_H Path is not given in the profile.
----iiiinnnniiiittttiiiiaaaallll _f_o_l_d_e_r
This option specifies an alternate folder which may
receive new mail and is initially opened by _x_m_h. The
default initial folder is ``inbox''.
----ffffllllaaaagggg This option will cause _x_m_h to change the appearance
of appropriate folder buttons and to request the
window manager to change the appearance of the _x_m_h
icon when new mail has arrived. By default, _x_m_h
will change the appearance of the ``inbox'' folder
button when new mail is waiting. The application-
specific resource cccchhhheeeecccckkkkNNNNeeeewwwwMMMMaaaaiiiillll can be used to turn
off this notification, and the ----ffffllllaaaagggg option will
still override it.
These three options have corresponding application-specific
resources, MMMMaaaaiiiillllPPPPaaaatttthhhh, IIIInnnniiiittttiiiiaaaallllFFFFoooollllddddeeeerrrr, and MMMMaaaaiiiillllWWWWaaaaiiiittttiiiinnnnggggFFFFllllaaaagggg,
which can be specified in a resource file.
The standard toolkit command line options are given in _X(_1).
Any of these options may also be specified on the command
line by using the X Toolkit Intrinsics resource
specification mechanism. Thus, to run _x_m_h showing all
message headers,
% xmh -xrm '*HideBoringHeaders:off'
If TTTTooooccccGGGGeeeeoooommmmeeeettttrrrryyyy, VVVViiiieeeewwwwGGGGeeeeoooommmmeeeettttrrrryyyy, CCCCoooommmmppppGGGGeeeeoooommmmeeeettttrrrryyyy, or PPPPiiiicccckkkkGGGGeeeeoooommmmeeeettttrrrryyyy
are not specified, then the value of GGGGeeeeoooommmmeeeettttrrrryyyy is used
instead. If the resulting height is not specified (e.g.,
"", "=500", "+0-0"), then the default height of windows is
calculated from fonts and line counts. If the width is not
specified (e.g., "", "=x300", "-0+0"), then half of the
display width is used. If unspecified, the height of a pick
window defaults to half the height of the display.
The following resources are defined:
bbbbaaaannnnnnnneeeerrrr A short string that is the default label of the
The initial text displayed in a composition window is
generated by executing the corresponding _M_H command; i.e.
_c_o_m_p, _r_e_p_l, or _f_o_r_w, and therefore message components may be
customized as specified for those commands. _c_o_m_p is
executed only once per invocation of _x_m_h and the message
template is re-used for every successive new composition.
_x_m_h uses _M_H commands, including _i_n_c, _m_s_g_c_h_k, _c_o_m_p, _s_e_n_d,
_r_e_p_l, _f_o_r_w, _r_e_f_i_l_e, _r_m_m, _p_i_c_k, _p_a_c_k, _s_o_r_t, and _s_c_a_n. Some
flags for these commands can be specified in the _M_H profile;
_x_m_h may override them. The application resource ddddeeeebbbbuuuugggg can
be set to true to see how _x_m_h uses _M_H commands.
EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
HOME - users's home directory
MH - to get the location of the _M_H profile file
FFFFIIIILLLLEEEESSSS
~/.mh_profile - _M_H profile, used if the MH environment
variable is not set
~/Mail - directory of folders, used if the _M_H profile cannot
be found
~/.xmhcheck - optional, for multiple mail drops in
cooperation with _s_l_o_c_a_l.
/usr/local/mh6 - _M_H commands, as a last resort, see mmmmhhhhPPPPaaaatttthhhh.
~/Mail/<folder>/.xmhcache - _s_c_a_n output in each folder
~/Mail/<folder>/.mh_sequences - sequence definitions, in
each folder
/tmp - temporary files, see tttteeeemmmmppppDDDDiiiirrrr.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
X(1), xrdb(1), X Toolkit Intrinsics, Athena Widget Set,
mh(1), enscript(1)
At least one book has been published about _M_H and _x_m_h.
BBBBUUUUGGGGSSSS
- When the user closes a window, all windows which are
transient for that window should also be closed by _x_m_h.
- When XXXXmmmmhhhhUUUUsssseeeeAAAAssssCCCCoooommmmppppoooossssiiiittttiiiioooonnnn and XXXXmmmmhhhhVVVViiiieeeewwwwUUUUsssseeeeAAAAssssCCCCoooommmmppppoooossssiiiittttiiiioooonnnn